Skip to content

docs: document --defer/--state gotchas in CLI reference#607

Merged
jpetey75 merged 2 commits into
mainfrom
mintlify/cli-defer-state-gotchas
May 12, 2026
Merged

docs: document --defer/--state gotchas in CLI reference#607
jpetey75 merged 2 commits into
mainfrom
mintlify/cli-defer-state-gotchas

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 8, 2026

Adds a "Using --defer with lightdash preview and lightdash compile" subsection under the dbt-flags list in the CLI reference.

Covers three points:

  • --defer only resolves Lightdash-joined upstream models against the prod state manifest; standalone tag:lightdash models not joined to a modified model don't appear (scope of fix: patch deferred model schemas when using --defer lightdash#20672).
  • Don't use --favor-state for preview workflows — it routes modified models back to prod relations.
  • The comma in --select is AND, not OR.

Source: lightdash/lightdash#12615, lightdash/lightdash#10911.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 8, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 8, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview May 8, 2026, 4:50 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 12, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@jpetey75 jpetey75 merged commit ff9a50f into main May 12, 2026
3 checks passed
@jpetey75 jpetey75 deleted the mintlify/cli-defer-state-gotchas branch May 12, 2026 13:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant